package com.ailanyin.modules.system.service;

import java.util.List;
import java.util.Map;

/**
 * @author ailanyin
 * @version 1.0
 * @since 2022/3/7 0007 上午 9:28
 */
public interface ISysRegionService {

    /**
     * 获取所有省
     *
     * @return list
     */
    List<Map<String, String>> getAllProvince();

    /**
     * 获取某省所有市
     *
     * @param provinceCode 省代码
     * @return list
     */
    List<Map<String, String>> getAllCityByProvinceCode(String provinceCode);

    /**
     * 获取某市所有区
     *
     * @param cityCode 市代码
     * @return list
     */
    List<Map<String, String>> getAllAreaByCityCode(String cityCode);

    /**
     * 获取某区所有街道
     *
     * @param areaCode 区代码
     * @return list
     */
    List<Map<String, String>> getAllStreetByAreaCode(String areaCode);

    /**
     * 获取省名称
     *
     * @param code code
     * @return 省名称
     */
    String getProvinceName(String code);

    /**
     * 获取市名称
     *
     * @param code code
     * @return 市名称
     */
    String getCityName(String code);


    /**
     * 根据省市区名称获取它们的 ID
     *
     * @param provinceName 省名称
     * @param cityName     市名称
     * @param areaName     区名称
     * @return ids
     */
    Map<String, Object> getIdsByNames(String provinceName, String cityName, String areaName);
}
